home *** CD-ROM | disk | FTP | other *** search
/ Underground / Underground CD1.iso / hack / progsy / hasla / johnr15 / DOC / README < prev    next >
Encoding:
Text File  |  1998-05-15  |  3.6 KB  |  93 lines
  1.  
  2.  John the Ripper -- Password Cracker
  3. =====================================
  4.  
  5. John the Ripper is a UNIX password cracker, currently available for UNIX,
  6. DOS, WinNT/Win95. Version 1.5 has been tested with Linux x86/Alpha/SPARC,
  7. FreeBSD x86, OpenBSD x86, Solaris 2.x SPARC and x86, Digital UNIX. There's
  8. also a generic make target that should work on most other UNIX systems.
  9.  
  10. The DOS and Win32 ports are done with DJGPP and Cygnus Developer's Kit,
  11. respectively.
  12.  
  13.  How to Install
  14. ----------------
  15.  
  16. See doc/INSTALL for information on installing John on your system.
  17.  
  18.  How to Use
  19. ------------
  20.  
  21. To run John, you need to supply it with some password files, and specify a
  22. cracking mode, like this, using the "single crack" mode, and assuming that
  23. passwd is a copy of your password file:
  24.  
  25.     john -single passwd
  26.  
  27. and then, with a wordlist:
  28.  
  29.     john -wordfile:/usr/dict/words -rules passwd
  30.  
  31. Cracked passwords will be printed to the terminal and saved in file called
  32. ~/john.pot (in this text '~' means John's "home directory", that is, the
  33. directory you installed John's binary in). This file is also used not to
  34. load passwords that you already cracked, when you run John the next time.
  35. To retrieve the cracked passwords, run:
  36.  
  37.     john -show passwd
  38.  
  39. While cracking, you can press any key for status, or Ctrl+C to abort the
  40. session, saving point information to a file (~/restore by default). By the
  41. way, if you press Ctrl+C twice John will abort immediately without saving.
  42. The point information is also saved every 10 minutes (see src/params.h) in
  43. case of a crash. To continue an interrupted session, run:
  44.  
  45.     john -restore
  46.  
  47. Anyway, you probably should have a look at doc/OPTIONS for a list of all
  48. the command line options, and at doc/EXAMPLES for more John usage examples
  49. with other cracking modes.
  50.  
  51.  Features and Performance
  52. --------------------------
  53.  
  54. John the Ripper is designed to be both powerful and fast. It combines
  55. several cracking modes in one program, and is fully configurable for your
  56. particular needs (you can even define a custom cracking mode using the
  57. built-in compiler supporting a subset of C). Also, John is available for
  58. several different platforms, which enables you to use the same cracker
  59. everywhere (for example even continue a cracking session that you started
  60. on another platform).
  61.  
  62. Out of the box, John supports (and autodetects) the following ciphertext
  63. formats: standard and double-length DES-based, BSDI's extended DES-based,
  64. FreeBSD's (and not only) MD5-based, and OpenBSD's Blowfish-based.
  65.  
  66. Unlike other crackers, John doesn't use a crypt(3)-style routine. Instead,
  67. it has its own highly optimized modules for different ciphertext formats
  68. and architectures. Some of the algorithms used couldn't be implemented in
  69. a crypt(3)-style routine: they require a more powerful interface (bitslice
  70. DES is an example). Additionally, there're assembly routines for several
  71. processors and architectures (special Intel Pentium version, x86 with MMX,
  72. generic x86, Alpha EV4, SPARC V8).
  73.  
  74.  Documentation
  75. ---------------
  76.  
  77. The rest of documentation is located in separate files, listed here in the
  78. recommended reading order:
  79.  
  80. INSTALL        - you've probably read it already
  81. OPTIONS        - command line options, and additional utilities
  82. MODES        - cracking modes: what they are
  83. CONFIG   (*)    - how to customize
  84. RULES    (*)    - wordlist rules syntax
  85. EXTERNAL (*)    - defining an external mode
  86. EXAMPLES    - usage examples -- strongly recommended
  87. FAQ        - guess
  88. NEWS        - history of changes
  89. CREDITS        - credits, and how to contact me
  90. (*) most users can safely skip these
  91.  
  92. Happy reading!
  93.